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PREFACE 


This manual describes the operation and use of the PDP-15 PATCH Utility 
Program, The PATCH program may be operated in either the ADVANCED 
Software System (ADSS) or the Disk Operating System (DOS) environment, 

NOTE 

In DOS systems , PATCH may be used only by the 
System Manager, 

It was assumed in the preparation of this manual that the reader was 
familiar with the operation of the PDP-15 equipment and the contents 
of the software manual describing the features of the particular 
monitor system in which he was operating, that is: 

a) for ADSS users, PDP-15 Monitor Software System 
Manual DEC—X5HMR2B-D; 

b) DOS Software System User's Manual, DEC-15-ODUMA-B-Do 

PDP-15 UTILITY PROGRAMS MANUAL, DEC-15-YWZB-D 


The PDP-15 Utility Programs manual is comprised of a set of individual 
manuals, each of which describes the operation and use of a PDP-15 
Utility Program. The manuals which make up the Utility Programs set 
are listed in the following Application Guide. In addition, the Appli¬ 
cation Guide also indicates the order number of each manual and the 
specific PDP-15 Monitor Software Systems in which the program described 

may be used. 


Technical changes made in this version of the manual are indicated by 
a bar (|) in the appropriate page margin. 



APPLICATION GUIDE 


PDP-15 UTILITY PROGRAM MANUALS 


PDP-15 Utility Program Manuals and the Application of Each 



Manual 

Applies to Monitor: 

Title 

Order Number 
DEC-15- 

DOS 

ADSS 

B/F 

DDT 

Utility Program 

YWZB-DN1 

/ 

/ 

/ 

CHAIN & EXECUTE 
Utility Program 

YWZB-DN2 

/ 

/ 

/ 

SGEN 

ADVANCED Monitor 

YWZB-DN3 


/ 


MTDUMP 

Utility Program 

YWZB-DN4 

/ 

/ 


PATCH 

Utility Program 

UPATA-A-D 

/ 

/ 

/ 

EDIT 

Utility Program 

YWZB-DN6 


/ 

/ 

UPDATE 

Utility Program 

YWZB-DN7 

/ 

/ 

/ 

LINKING LOADER 

YWZB-DN8 

/ 

/ 

/ 

PIP 

ADVANCED Monitor 

YWZB-DN9 


/ 

/ 

SRCCOM 

Utility Program 

YWZB-DN11 

/ 

/ 

/ 

SGEN 

DOS Monitor 

USGNA-A-D 

/ 



PIP 

DOS Monitor 

UPIPA-A-D 

/ 
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SECTION 1 


INTRODUCTION 


1.1 PATCH PROGRAM 


The PATCH Utility program enables the PDP-15 user to view and modify 
System Programs and data on specific device data blocks. The commands 
provided by PATCH may be entered via the console keyboard or, in the 
monitor Batch mode, via either paper tape or card reader unit. 

This manual is concerned only with user-controlled PATCH operations. 
The operation of PATCH under monitor Batch control is described in the 
applicable monitor (ADSS or DOS) reference manual (see Table 1-1). 

1.2 MANUAL ORGANIZATION AND USE 


This manual is intended for users who are familiar withs 

a) the general operating procedures (i.e., use of equip¬ 
ment and startup procedures), and 

b) the elements, structures and use of the particular 
monitor software system in which PATCH is to be used. 

Introductory information and detailed descriptions of each PATCH 
function and their applications are given in Sections 2 through 5. 

Section 6 summarizes the PATCH startup and operating procedures. 

New users of PATCH should familiarize themselves with the contents 

o £ Sections 1 through 5; thereafter, they need only refer to Section 

6 for concise information. 

Two Appendices are included which contain supplementary System Block 
(SYSBLK) and System Program descriptions. 

SYSBLK is described in Appendix A, System Programs are discussed in 
Appendix B. 



1.3 SUPPORTING DOCUMENTS 


Table 1-1 lists PDP-15 documents which either support directly or con¬ 
tain information useful in understanding PATCH and its functions. 

Table 1-1 

Supporting Documentation 


TITLE ORDER NUMBER 


ADSS Manuals 



al 

ADVANCED Monitor Software System 
for PDP-15/20/30/40 

DEC-15—MR2B-D 


bl 

PDP-15/20 User's Guide 

DEC-15-MG2B-D 


c) 

SGEN ADVANCED Monitor Utility Program 

DEC-15-YWZA-DN3 

DOS 

Manuals 



al 

DOS User 8 s Manual 

DEC-15-ODUMA-B-D 


b) 

DOS Keyboard Command Guide 

DEC-15-ODKCA-A-D 


cl 

SGEN—DOS Utility Program 

DEC-15-US GNA-A-D 


dl 

DOSPIP Monitor Utility Program 

DEC-15-UPIPA-A-D 

B/F 

Monitor Manual 



al 

PDP-15/30, PDP-15/40 B/F 

Monitor Software Systems 

DEC-15-MR3A-D 

Common 

Manual 



a) 

MACRO-15 MACRO-Assembler Program 

DEC-15-LMACA-B-D 

1.4 

MAJOR PATCH FUNCTIONS 


The 

ma j 

or functions for which PATCH may be used 

are: 


a) the loading of relocatable programs assembled by MACRO-15 
into a system as a System Program (described in Section 3)? 

b) the loading of absolute programs assembled by MACRO-15 and 
data onto a System Program area (described in Section 4) •, 
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c) the modification of registers located in 

11 System Programs, 

21 Data blocks, 

31 System SYSBLK (system block). 

The items on which PATCH functions may be performed together with a 
description of the commands and procedures needed for their selection 
are given in Section 2. 

1.5 PATCH, I/O DATA FLOW PATHS 

Figure 1-1 illustrates the primary data flow paths employed during 
PATCH operations. 

User command/response operations are carried out via a console/printer 
unit ffl Peripheral devices/UFD's containing the files to be patched 
must be assigned to .DAT-14; those devices containing auxiliary input 
files must be assigned to .DAT-10. 
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Figure 1-1 PATCH Operations, Information 
Flow Diagram 
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SECTION 2 


SELECTION OF ITEM TO BE PATCHED 

All operations explained in this section are done under control of the 
PATCH programo 

2.1 SELECT FUNCTION 

The first step required in any PATCH procedure is the selection of the 
item (.DAT -14) to be patched., Two basic commands "Program Select", 
and "Block Select" are provided for this purpose. 

2.1.1 Program Select Command 

The System Programs located on the device assigned to .DAT -14 are 
selected for PATCH operations by the entry of a unique name which is 
stored in a monitor table; these unique names enable the monitor to 
identify the requested program. 

The format for a Program Select command is: 

(The right angle bracket is the PATCH program user-prompt character.) 


For example, to select the Editor program the entry 
>EDIT ) 
is entered. 

The entry of a System Program name merely identifies the item to be 
operated upon; no further action is taken until a PATCH function is 
initiated by another command. 


NOTE 

The Program Select command may be used only if 
the device assigned to .DAT -14 contains a Sys¬ 
tem Block (SYSBLK). 

In addition to System Programs, system Device System Block (SYSBLK) 
and CTRL Q (tQAREA) areas may also be selected for PATCH operations. 
Table 2-1 lists the unique names of the programs normally supplied as 
System Programs with ADSS and DOS software systems. 



TABLE 2-1 


PATCH Accessible System Programs 

MONITOR 



PROGRAM 

NAME 

DOS 

ADSS 

1) 

DOS Resident Monitor 

RESMON 

/ 


2) 

System Loader 

.SYSLD 

/ 

✓ 

3) 

Control Q Area 

IQAREA 

/ 

/ 

4) 

Standard Editor Program 

EDIT 

/ 

/ 

5) 

Text Editor for VT15 Graphics 
Display 

EDITVT 

/ 

/ 

6) 

Text Editor for VP15 Storage 

Tube Display Unit 

EDIT VP 

/ 

/ 

7) 

Peripheral Interchange Program 

PIP 

/ 

/ 

8) 

Macro-Imbedded Assembler for 8K 
Systems Only 

MACROI 


/ 

9) 

Macro-Assembler Program for 

PDP-15 (MACRO-15) 

MACRO 

/ 

/ 

10) 

Cross Reference Program 

CREF 

/ 

/ 

11) 

System overlay build program 

CHAIN 

/ 

/ 


Overlay EXECUTE program 

EXECUTE 

/ 

/ 

12) 

System Generator 

SGEN 

/ 

/ 

13) 

System Generator, Section 2 

.SGEN2 


/ 

14) 

System Generator* Section 3 

.SGEN3 


/ 

15) 

FORTRAN IV (16K) 

F4 

/ 

/ 

16) 

FORTRAN IV Imbedded (8K Systems 
Only) 

F4I 


/ 

17 

Core Dump Program 

QFILE 

/ 


18) 

General Dump Program 

DUMP 

/ 

/ 

19) 

DECtape Copy Program 

DTCOPY 

/ 

/ 

20) 

System Patch Program 

PATCH 

/ 

/ 

21) 

Library UPDATE Program 

UPDATE 

/ 

/ 

22) 

Source Compare Program 

SRCCOM 

/ 

/ 

23) 

DOS non-resident MONITOR 

DOS15 

/ 


24) 

Keyboard Monitor* KB-15 

KM15 


/ 

25) 

9-15 Keyboard Monitor* KM9-15 

KM9-15 


/ 

26) 

Macro Assembler Program for 

PDP-11 (Macro-11) 

MACH 1 

/ 


27) 

Input/Output SPOOLER Program 

SPOOL 2 

/ 



1 UNICHANNEL-15 systems only, 

2 RKJ35 based UNICHANNEL-15 systems only. 
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2.1.2 Block Select (B) 







A single 40# g -word data block located on the device assigned to .DAT -14 
is selected for PATCH operations, using a "B: Block Select command. It 
is not necessary to select a system program before performing this 
operation. 

FORMATS: a) >B n \ 

LJ 0 

or 

bl >B-f fej n ) (DECtape only) 

or 

c) >B—. ,n £ (DECtape only) 

where: 

1) B identifies the Block Select command 

2 \ + indicates the selected block should be read 

in the forward direction. 

31 - indicates that the selected block < should be 

read in the reverse (counter-clockwise) direction. 

41 n represents an octal number which identifies 

a logical block on the PATCH I/O device (.DAT -14). 

The value of n must be greater than or equal to 
J2L 

DESCRIPTION: 

The entry of a "B" select command relocates the identified word block 
into a PATCH Block Buffer in core. In relocating the block, the load 
address is set to ft, the size is set to 4 / 0' / 0g , and the block number is 
as specified. If the block number (n) in any of the select commands 
is followed by a space, any data on the remainder of the input line is 
treated as a comment and is ignored. For example: 

>B 100 COMMENT J 

a— i a—-« ** 

is permitted. 

The 8 L 8 operation (refer to Section 5.2.3) is permitted under the 
8 B 5 command. 
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SECTION 3 


LOADING RELOCATABLE PROGRAMS AS SYSTEM PROGRAMS 


3.1 PATCH LOAD FUNCTION 


A PATCH load function enables the user to convert a relocatable file 
into an absolute SYS file format and load the converted file onto a 
system device as a System Program. This section describes in detail 
the PATCH command used, the procedure required, the relocatable file 
requirements,, and the operations performed by PATCH. 

The PATCH load function can only be used when the system on .DAT -14 
has been prepared by SGEN to receive the converted file. During SGEN 
procedures (refer to appropriate SGEN manual) the user must enter the 
name of each program to be installed, specify .DAT slot usage, and 
indicate the order in which the System Programs are to appear in the 
newly generated system. The program name, number of system blocks 
required, and .DAT slot usage information entered during SGEN is stored 
in the system device SYSBLK. 

3.2 PATCH READR LOAD COMMAND 


The command "READR" initiates the PATCH relocatable-to-SYS file pro¬ 
gram load function. The general format of this command is as follows: 


>READR [nnnnn] [filename] [ext] [comments] ) 

tLsreaJ fessedj Iraggwa p g ^ 

where: 


nnnnn = the highest 13-bit core address to be occupied by 
the relocated file when it is loaded into core as 
a SYS file. If an address is not specified, the 
first free register below the bootstrap is assumed 
by PATCH. If specified, the value of nnnnn must 
be <_17636g; a larger value will cause an error. 

filename = the name of the relocatable file 1 B 

ext = filename extension; if not given, BIN is assumed. 

comments = if desired, a comment may be added to the command 

string, but only if the extension is given explicitly. 


a NOTE: Filename may be omitted for non-file oriented auxiliary 

devices (.DAT -10). 




3.2.1 Procedures 


The READR command must be preceded by a program select command which 
identifies the system device area (named in SGEN) into which the modi¬ 
fied file is to be written. For example, the sequence: 

>8TRN} 

>READR 8TRAN ) 

must be entered to install the file 8TRAN onto a prepared system de¬ 
vice at .DAT-14, given the name 8TRN. 

On the execution of a READR command, PATCH obtains the named file from 
.DAT-10 and checks it for required size and program characteristics 
Csee paragraph 3.2.2). If the file is not acceptable, the load opera¬ 
tion Is halted and an appropriate error message is output to the user. 

If the file is acceptable, PATCH relocates addresses within the input 
file, builds a table of the transfer vectors contained by the file, 
and appends the .table and a Bank Bit Initialization routine to the 
file. The modified file and its appended routine and vector table are 
then loaded as a unit, in core image form, onto the system device at 
.DAT-14. 


PATCH automatically changes the patch parameters in SYSBLK. Relocation 
and the Bank Bit Initialization routines are described in paragraphs 
3.3 and 3.4, respectively. 

3.2.2 Input File Requirements 

In order to be installed onto a system as a SYS file, a relocatable 
file at .DAT-10 must: 

1) not contain more than 256 transfer vectors 

2) not contain external .GLOBL references 

3) not use indexed instructions 

4) not have a core image size greater than the number of 
system blocks allocated multiplied by 400 o 

O 

5) not cause the total program size to exceed. 8K 

6 ) not contain COMMON references 
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NOTE 


The total installed size of a program may be computed 
by adding: 1) the size of the binary program, 2) the 
number of transfer vectors, and, 3) 32 8 word locations 
which are occupied by the Bank Bit Initialization 
routine. 

3.3 RELOCATION 

MACRO-15 outputs relocatable programs addressed as if they were as¬ 
sembled starting in location 0 of core. Relocatable programs are 
normally loaded into core for execution by the Linking Loader System 
Program which, at load time, computes the difference between the 
MACRO—assigned addresses and the addresses of the actual core area 
into which the program is to be loaded for execution. This computed 
difference, called the relocation factor, is then added to each loca¬ 
tion address contained by the program as it is loaded into memory. 

The relocation factor properly orients the relocatable program within 
memory. 


3=3.1 PATCH READR File Relocation 

During the execution of a READR command, PATCH calculates the required 
13—bit relocation factor by subtracting the program size from the 
final (highest) address the program is to occupy. The final address 
is either specified in the READR command by the user or, by default, 
17636g is assumed. 

The relocation factor, recognized by PATCH as the symbol #, is then 
incremented by 1 for each word location and the resulting value as¬ 
signed as the address of the location. For example, the relocation 
factor (#) for a relocatable program 400 words in size with no address 
specified in the READR command would be calculated: 

# = 17636g - 400g + 1 = 17237g 

In order to relocate the program addresses (0 through 377) for con¬ 
version to the absolute values required for SYS files, PATCH then 
increments the relocation factor by 1 for each position and assigns 
each value obtained as an address to the corresponding program word 
location? i.e.. 




# + 0 ~ address of first word location (17237 0 ) 

• O 

# + 377 = address of last program word location (17636 0 ) 

8 

PATCH also relocates the addresses contained by the memory reference 
instructions and transfer vectors found in the input program. 

3-4 BANK BIT INITIALIZATION (BBI) ROUTINE 


Transfer vectors contain 15-bit addresses which include bank identity 
bits and the 13-bit, 8K word location addresses. The format of a 
Transfer Vector data word and the interpretation of its address por¬ 
tion isz 


j 1 

2 

3 

4 

5 

6 


17 


BANK 


BANK 

BITS 



I 
I 

113-bit BANK WORD LOCATION ADDRESSES 
! 

I 

o j—► ooooo to mu 

1 —20000p to 37777p 

0 —► 40000® to 57777® 

1 60000® to 77777® 


During READR relocation operations the relocation factor is added to 
the least significant 13 word bits of the Transfer Vector to relocate 
the bank word address which it contains. The bank bits of a Transfer 
Vector cannot be relocated at the time the file is installed as a System 
Program since the number of the highest bank of a system varies ac¬ 
cording to the overall size of the system. 


To ensure that transfer vector bank bits are relocated prior to run 
time, PATCH, during READR operations, develops a table of transfer 
vector locations, adds the table to a Bank Bit Initialization routine, 
and appends the routine to the input program. The BBI routine is 
installed onto the system device medium as part of the new System 
Program. 


When a READR-instailed program is loaded into core, its associated 
BBI is also loaded immediately below the program (see Figure 3-1). 
The loader, .SYSLD, on completion of its functions, turns control 
over to the BBI routine. The BBI routine determines what bank the 
System Program has been loaded into and updates the bank bits of all 
Transfer Vectors contained by the program. The routine identifies 
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the vector words from the Transfer Vector table developed during 
PATCH READR operations. 

On completion of its initialization function, this routine sets the 
contents of the .SCOM+3 pointer to the address of the last word loca¬ 
tion occupied by the routine and turns control over to the System 
Program, 

The modification of .SCOM+3 at the end of BBI functions frees the 
core occupied by this routine for use by the System Program, 

J 

The basic portion of the BBI routine requires 32 0 word locations. 

o 

The routine Transfer Vector table requires an additional location for 
each Vector in the program. A maximum of 400g vectors is permitted. 

The PATCH appended BBI routine relives the user of the responsibility 
of including a routine to perform this function. 

3* 5 READR ESTABLISHED SYSTEM COMMUNICATIONS AREA 

The ability to specify in the READR command the highest load address 
for the program being loaded permits a buffer area to be set up 
between the last program address and the first address of the boot¬ 
strap. Such a buffer would provide READR-loaded programs with a 
common core-resident buffer for intra-program communications and/or 
common data storage. 
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3 ° 5 LOADING PATCH-RELOCATED CORE IMAGE SYSTEM PROGRAMS 


READR-instailed Systems Programs and their associated Device Handlers 
are loaded into core from the system device by the System Loader 
C.SYSLD) program* 

The placement of READR-instailed System Programs and their device 
handlers in core is illustrated in Figure 3-1* 
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LEGEND I 


EXTRA 1 
4K PAGE 


N is s 

00000 for 8K 
20000g for 16K 
40000^ for 24K 
60000g for 32K 



17777 0 + N 

o 


17636g + N 


„SCOM + 3 Adjusted value 
after BBI initialization 
operation 


’tf’ SL - .SCOM + 3 Initial Value 


00020g + N Lowest Limit for 
SYS file BBI initia¬ 
lization routine 


, SCOM + 


2 


. SCOM + 1 


1 An extra 4K page is not used for 
loading core image programs, it 
is used only for handlers. 


2 MAC11, supplied with UC15 systems 
always runs in Bank "1" due to 
restrictions in the Common 
Memory Space. 


i 


Figure 3-1, Memory Map, Loading a READR-Instailed 
SYS-file 
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LOADING ABSOLUTE PROGRAMS AND DATA 


4.1 READ AND PATCH FILE FUNCTIONS 

This section contains detailed descriptions of the READ load function, 
the function user commands, and the load operation* Patch files, the 
input sources to PATCH during READ load function, are also described 
in detail. 

4.2 READ LOAD FUNCTION 

The "READ" load function enables the user to transfer absolute "Patch 
files" from the auxiliary input device (.DAT-10) into a user-selected 
program or data block located on the device at .DAT -14. 

A Patch file is an absolute program written by the user to operate with 
the PATCH READ load function; its purpose is to direct the PATCH program 
in loading information contained by the file into a specific register 
or series of registers located within a program or data block of the 
device on .DAT-14. Entire programs or data blocks, as well as selected 
items, may be loaded from Patch files onto the device at .DAT-14, using 
the PATCH READ load function. 

Patch files are used as a means of making changes (i.e. patches) to 
existing SYS files or a device data block or for installing a new 
version of a System Program onto a system device. They are particu¬ 
larly useful when the same patches are to be made to a SYS file 

contained by more than one system device. 

NOTE 

When patching or replacing a System Program, care 
must be taken to ensure either that the existing 
SYSBLK parameters are not affected or that they 
are changed to comply with the characteristics of 
the replacement version of the program (see 
paragraph 4.5). 

4.3 READ COMMAND 

The command READ initiates the performance of the absolute load 
function. This command may have any of the following formats: 

a) >READj (for non-directoried devices only ) 

b) >READ u [filename] J 

c >READut[ f ilename]ext [comment] J 
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where i 


1) filename is the name of the Patch file to be input 
from .DAT-10* The use of a filename extension 
(format c) is optional* If not given, the extension 
is assumed to be ABS. 

2) Comments may be added to command strings having the 
format shown in item c. 

3) Patch files on paper tapes do not require a 
filename (see item a)* 


NOTE 

The READ command must be preceded by either a 
Program Select or Block Select command. The 
patch file read must be a .ABS macro program. 


4.3.1 READ Load Operation 

During READ command load operations, PATCH loads into core one 400,,- 

8 

word block at a time from both the Patch File and the selected program 
or data block. Once both blocks are loaded, PATCH processes in 
sequence each word of the Patch File block. Using reference data 
supplied in the Patch File, PATCH determines the address within the 
user selected program or data block which corresponds to that 
addressed by the Patch File word being processed. If the addressed 
register is within the selected program or data block currently in 
core, the contents of the Patch File word are loaded into that 
register by PATCH. 

If the addressed register is not in the block currently in core, the 
block in core is written back into the device at .DAT— 14 and the block 
containing the addressed register is loaded. After the new block is 
loaded, PATCH locates the addressed register and writes the contents 
of the Patch File word into it. 

A user-selected data block is handled, during READ operations, as if 
it were an absolute program having addresses ranging from 00000 
through 00377^. If more than one data block is to be patched, a 
separate Patch File is required for each block and individual Select . 
Block and READ commands must be issued for each. 

If a Patch File word addresses a location not within the limits of 
the selected program or block, PATCH outputs an ADDRESS OUT OF 
RANGE error to the user console teleprinter (refer to Section 6 
for description of error messages). 
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4.4 WRITING PATCH PROGRAMS 


The following is an example of the proper format for a PATCH assembly 
source program to be assembled and output by MACRO-15: 


PATCH FILE 


.TITLE 

anything 

.ABS 

NLD 

.LOC 

734777 

234 

6$$261 

.LOC 

35$ 

-3 


.LOC 

371 

$4$ 674 



.END 


MEANING AND OPERATION PERFORMED 


No Loader. 

Set location counter to address 234. 
Set contents of 234 to 734777, and 
go to next location. 

Set contents of 235 to 600261. 
Advance counter to location 35$. 

Set contents of 35$ to -3. 

Advance location counter to 
address 371. 

Write $4$674 into LOG 371 


End program. 


The commands available for patching system programs assembled under 
MACH are the ' B' (block) command and the 'L 1 (location) command® 


As illustrated in the above example, .LOC statements in the patch 
program are recognized by PATCH as pointers. These pointers direct 
PATCH to start a replacement operation at a specified address in the 
program or data block being patched. In the replacement (overwrite) 
operation, the contents of the Patch File location immediately follow¬ 
ing the .LOC statement is written, by PATCH, into the selected program 
or data block location pointed to by the .LOC address. PATCH then 
writes, in sequence, the contents of the following Patch File locations 
into the registers of the file be:hg patched immediately following the 
one pointed to by the patch file ,LOC statement. All patches are 
written as if the program is to bs loaded into the first bank (13 
bit addresses). All transfer vectors in a .ABS program must be 
bank-bit initialized before use. 
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The current replacement operation continues until another .LOG state¬ 
ment is reached in the input Patch File.. The new .LOG statement ends 
the current replacement operation and directs PATCH to go to a new 
start location and to start another replacement operation. 

The Patch File operations are terminated when PATCH reaches the PATCH 
File .END statement. 

4.4.1 Partial Overlay Patch Program s 

A Patch Program written to change the contents of specific locations 
or groups of contiguous locations throughout a selected program or 
data block acts as a partial patch to the file being modified? only 
those items specified in the Patch Program are affected. The Patch 
Program in the example in paragraph 4*4 represents a partial patch. 

Patch programs may only be used to change the contents of registers 
already existing within a selected program or data block? they cannot 
be used to insert information between existing program lines. 

4.4.2 Replacing Complete Programs or Data Blocks 

Patch Programs may be written to replace an entire absolute System 
Program or 400g-word data block. To accomplish this, the user sets 
the first Patch File .LOC statement to point to the first location 
of the program or data block to be replaced and follows it with the 

replacement program or data block.. For example: 


.TITLE 

-ABS 

.LOG 


'I' 


Replacement 
Program or 
Block 


1 ' 


.END 


(Patch Program name) 

NLD 

(First Location of selected program or 
data block) 


4.5 PRECAUT I ONS TO BE OBSERVED FOR PATCH READ OPERATIONS 

The PATCH READ load operation does not modify (i.e., update) SYSBLK on 
completion of the function. If any changes are made to a System Program 
which affect the parameters stored for it in SYSBLK, the user must 
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change these parameters using the PATCH List function (described in 
Section 5 ) ® Indexed instructions are not permitted® 

When overlaying a complete program with a new version, the user must 
ensure that the new version will fit into the area allotted to that 
program during SGEN. All . ABS program transfer vectors must be bank™ 
bit initialized by the program itself before it uses them if the core 
image is loaded above 8K. 
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SECTION 5 


LISTING AND MODIFYING PROGRAM AND DATA BLOCK REGISTERS 


5.1 REGISTER MODIFICATION FUNCTIONS 

This section describes the functions, commands and procedures which 
enable the user to select and modify individual registers within? 

a} SYS files initially written as absolute programs, 
bl READR-instailed SYS files, 

c} a system device SYSBLK Program Parameter Table, and 
d] a system save, fQAREA, area. 

5 - 2 PATCH LIST FUNCTION 


PATCH register modification is carried out as a list operation in 
which the address and contents of each register selected by the user 
are listed (printed) on the user 8 s console teleprinter. On completion 
of the print operation, the user may enter, if desired, an expression 
to replace the contents of the currently listed register. When the 
user is through with the currently selected register, he terminates 
that operation and either terminates the function or directs PATCH 
to list the contents and address of another register. The program 
or data block containing the register (s) to be modified must be 
identified by the entry of a Select command (see Section 2); the 
specific register to be viewed and modified (if desired) is selected 
by the user with a "List" command. Three types of List commands are 
provided by PATCH: 

a) L command , used to select and initiate the list 
operation for registers within any selected SYS” 
file, data block, SYSBLK or QAREA contained by 
the device on .DAT -14. 

b) LR command , used only for the selection and list¬ 
ing of registers within READR-installed SYSfiles. 

c) SYSBLK Program Parameter Commands , five separate 
commands, each of which initiates the list opera¬ 
tion for a specific SYSBLK parameter for the cur¬ 
rently selected SYSfile. Used only with SYS files. 

The format and use of the above List commands are described in para¬ 
graphs 5-3, 5-4, and 5-5, respectively® 
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5.2.1 List Operation 


The PATCH operations performed during a List operation are: 


aI On the entry of a list command, PATCH loads the 400 
word data block or selected Program block containing 
the user identified register into core. The selected 
register is opened by PATCH and its address and con¬ 
tents are printed on the console teleprinter unit. 

bl PATCH waits for the entry of a modifier and/or a 
terminator. 

cl PATCH writes the input modifier (if made) into the 
opened register and examines the line terminator to 
determine the next operation to be performed. De¬ 
pending on the terminator entered (see 5.2.3) PATCH 
terminates the List function or opens another 
register. 


5.2.2 Expressions 


Expressions, as defined for MACRO-15 (see DEC-IS-LMACA-B-D ) r are strings 
of symbols and numbers separated by arithmetic or Boolean operators. 
Octal numbers of from one to six digits (J0T to 777777 ) or alphanumeric 
symbols of from one to three characters may be used as expressions or 
as components of an expression. 

In PATCH List operations, expressions are entered as replacements for 
the contents of a program or data block register. Expressions entered 
to change or modify a data word consist of up to six octal digits, 
originally preceded by a minus sign; those entered for an instruction 
word consist of an instruction operation code and an operand. PATCH 
contains symbol tables for all of the PDP—15 basic instructions op¬ 
codes and the operate group instructions with the octal values of 
each. The user can, therefore, patch registers using symbolic rather 
than octal representations of MACRO-15 instructions (e*g *, an expression 
may be entered as LAC 17536 instead of its octal form, 217536). 

The operators recognized by PATCH are listed in Table 5-1. 
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TABLE 5-1 


Operators Recognized by PATCH 


FUNCTION 

Two’s complement subtraction 
Inclusive OR 

Two 1 s complement addition 


The asterisk (*1 in addition to its use as an operator, also sets the 
indirect bit of the expression by causing 20000 o to be XORed into the 

O 

value of the expression. The XOR operation occurs each time that the 
symbol (*) is encountered; two sequential asterisks negate the setting 
of the indirect bit. 

** = 20000 XOR 20000 = 0 

The value of a PATCH expression is null (no modification is made to 
the opened register) unless the expression contains a number, symbol 
or an asterisk. 

Expressions are evaluated from left to right assuming an initial value 
of zero followed by a + operator (i.e., 0 + User's expression). Lead¬ 
ing and trailing operators are legal in an expression but the latter 

are ignored. Whenever a string of consecutive operators is used, only 

the last one in the string is used by PATCH in evaluating the expression. 

NOTE 

The LAW is a special case in PATCH; it should be 
used only in the following ways; 

a) LAW^n which is equivalent to 7 60000+n 

b) LAW, ,-n which is equivalent to -n. 

The use of LAW (LOAD ACCUMULATOR WITH this number) 
in any manner other than that described below will 
result in an error. 


OPERATOR 




H (tab) 




J 
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5.2.3 List Operation, Line Terminator 


When all list operations for an opened register are completed, one of 
four possible Line Terminators is entered to close the register and 
indicate the next list operation. The line terminators are described 
in Table 5-2. 


Table 5-2 List Operations, Command String Terminators 


ENTRY 



DESCRIPTION OPERATION 

Carriage Return Open and list the next sequential 

register 

Up Arrow and Carriage Open and List the register which 
Return precedes the current register. 

Treat any entries after t as a 
comment. 

Open and list the contents of the 
register pointed to by the address 
portion of the word contained in the 
currently opened register. Treat 
any entries after «- as a comment. 

ALT MODE Terminate current list operation? 

write PATCH buffer block onto 
.DAT -14 and wait for next entry. 


Back Arrow and Car¬ 
riage Return 


5.3 L LIST COMMAND 


The L List command has the following format: 




where 


al L initiates the list operation, and 

b) n represents the octal form of the 13-bit address of 
the location to be opened. When the L command is used 
to open registers of READR-instailed SYS files the 
address n must be the relocated (i.e., address after 
relocation) value. 



The response to an L command is a printout having the following formats 


>address of opened location) / (contents of opened location)> 
EXAMPLE : 

>L 132 

a Ess i00132/777435> (location 132g; contents 777435g) 

After outputting the address and contents of the accessed location, 
PATCH prints its go-ahead symbol (>) and waits for: 


1) the entry of an expression to replace the current con¬ 
tents, to modify the opened location. 

For example: 

> (address)/(current contents)>(expression or new contents) 

2) the entry of selected string terminator to indicate the 
next sequential list operation. 


5-3.1 Example: Select, List and Modification Procedures 


The following illustrates the use of PATCH select and list commands in 
the modification of a hypothetical system program named JOVE. 


PROCEDURE 


DESCRIPTION 


> JOVE 
> L 100J 

>00100/777435> J 
>00101/600200> 213775 J 

>00102/111215 > 00 300*- J 

>00300/000110>t J 
>00277/703112>@ 


Select System Program JOVE. 

Initiate List operation starting at loca¬ 
tion 100 

PATCH prints address and contents of 
opened location; user enters J to go to 
and open next sequential location. 

Address and contents of location 101 are 
printed, user changes contents from 
600200 to 213775 and opens the next sequen¬ 
tial location. 

User modifies contents of location 102 and 
commands PATCH to go to and open the loca¬ 
tion addressed by the contents of location 
102 (i.e., location 300). 

User enters i J to open and examine con¬ 
tents of preceding location (i.e., 277). 

User terminates current list operation 
by entering ALT MODE (symbol @). 

PATCH prints a go-ahead symbol to indicate 
that it is ready for the next operation. 



5=4 LR LIST COMMAND 


The LR List command has the following formats 


>LR 


n) 


where LR initiates the listing operation for a previously selected 
READR-instailed Systems Program, and n represents the 13 bit ''unrelo¬ 
cated" address (in octal) of the program location to be opened. 


NOTE 

PATCH automatically calculates and adds the needed 
relocation factor to the user's entry (i.e. f n). 

This enables the user to work directly from origi¬ 
nal unrelocated listings. 

The major difference between the "L" and "LR" list operations is that 
in L operations only absolute address information is output in responses 
and is required in modification procedures. In LR operations, however, 
the user must deal with both relocated and unrelocated addresses in 
list printouts and in register modification procedures. 

When the LR command is used to open word locations containing either 
data or non—memory reference instructions, the responses output are 
similar to those described for the L command. The only difference is 

that in the LR responses the address of the accessed location is given 
in relocated form relative to the original MACRO-15 assigned address. 


NOTE 

In the following paragraphs the symbol # is used to 
denote the relocation factor used by PATCH in the 
conversion of an unrelocated program into a system 
program. 


To illustrate, assume that 6 is the unrelocated address of a user- 
selected location containing a non-memory reference instruction or data 
and that the relocation factor (#) is 17344. The response to the 
command; 
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is printed in the following forms 


>17344 + 6 / nnnnnn > 

Relocated /Contents of location (6 digits) 

Address / Op-Code and Operand or Data 

For examples 

>17352/0172Q6> 

To illustrate, assume that a relocation factor of 17642 is current and 
that the selected program location 101 contains a JMP „+l instruction. 
The response to the commands 

>LR,_ 1 W1) 

is printed in the following forms 
>17743/617744<00102> 

Relocated /Contents, Op-Code + # + Operand /Unrelocated Operand\ 
Location / (600000 + 17642 + 102 \Referenced Address / 

Address / JMP=600000 (i.e., 00102) 

(177642+101) .+1 = 101+1 = 102 

Printing an address operand in its unrelocated form enables the user to 
easily recognize the instruction containing it, and the referenced lo¬ 
cation without calculating and subtracting the PATCH relocation factor 
(#) . 

The unrelocated referenced address within a memory-reference type instruc¬ 
tion is not printed by PATCH if it is less than the first address of the 
program? the address printed in angle brackets is always positive, though 
it may be zero. 

5.4.1 LR, Register Modification Procedure 

The contents of registers opened during LR operation are changed, as 
for L list operations, by the entry of an expression which is to re¬ 
place the contents of the current location. New contents are entered 
immediately after the listed response and replace the current contents 
on termination of the user input. 



Input expressions are formed using: 


a. Octal numbers up to six digits in length; 
PATCH always assume a six-digit input and 
right-justifies all numeric inputs (e.g., 
an entry of 300g is recognized as 000300g). 

b. Operators (symbols) as listed in Table 5-1. 

c. Symbolic representation of all PDP-15 basic 
instruction op-codes and operate group in¬ 
structions . 

d» The symbol # to represent the relocation 
factor of the currently selected,. READR- 
installed System Program. 


Command string terminators indicate the next sequential operation to 
be carried out (refer to Table 5-2). 

5.4.2 Relocation and LR List Operation Examples 

The following examples use a single memory reference instruction to 
illustrate the relocation operations performed by READR in the instal¬ 
lation of a SYS file and the manner in which the instruction may sub¬ 
sequently be examined using the LR command. 


EXAMPLE; 


a. Assume the instruction LAC„ „300 located in MACRO as¬ 
signed location 200 of an unrelocated 400g-word pro¬ 
gram. 

b. The program is selected by the user and is patched 
onto a prepared system device medium as a SYS file 
using the READR function/command. 

Program >Filename (name given at SGEN time) 

Name >READR Filename (current name of program) 

c. During READR operations? a relocation factor is cal¬ 
culated and added to all location addresses contained 
by the program. For a 400g-word program # = 17237 g . 
Therefore? the relocatable input memory reference 
instruction 

Address Instruction 


200 g LAC 300 

is relocated as 


(#+ 200 ) 


(LAC #+300) 



which eeruals * 


Address Instruction 
17437 g LAC 17537g 


or, in full octal form: 

17437 217537 

The relocated instruction is then output to the system 
device. 

d. To examine the instruction given in step c. in a READR- 
installed SYS file, the user calls PATCH, selects the 
program, and uses the LR command 

$PATCH 
>Filename 

The responses output at the I/O console will be: 

>17 43 7/217 53 7< 00300> 

e. To change the contents of the location, the user enters 
the desired expression and terminates the command string. 
If the contents contain an address, the relocation factor 
must be added to the new entry. 

For example, to change the address references in the con- 
tents of the location opened in step d from the 300g to 
305g Cunrelocated values),the user must enter the expres¬ 
sion: 

217544 8 

if he knows the value of the relocation factor # (i.e., 

17237 + 305). 

or 

LAC # +3 0 5 0 
8 


EXAMPLE: 


>17436/217537< 00300> LAC#+3^5 ) 
changes the location to 
17436/217544 

and the terminator J causes the next sequential loca¬ 
tion to be opened and a response output. 
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5.5 SYSTEM PROGRAM SYSBLK PARAMETER COMMANDS 


PATCH provides, as a convenience for the user, five separate commands 
which obtain and modify, if desired, SYSBLK parameters for the user 
selected program currently in core. By entering the appropriate com- 
mand from the following list and using suitable terminators as listed 
in Table 5-2, the user may start the listing at any specific point and 
proceed subsequently through the desired parameters. 

The commands, the parameters opened, and the word positions are as 
follows: 


Command 

SYSBLK Parameter Opened 

Word Position 

a) 

FB J 

Number of first block used 

3 

b) 

NB J 

Number of blocks allotted to 
program 

4 

c) 

FA J 

First core address occupied 
when the SYSfile is loaded 
into core (13-bits) 

5 

d) 

PS J 

Program Size 

6 

e) 

SA J 

Starting Address (13-bits) 

7 


When examining the parameter group of a READR-instailed System Pro¬ 
gram, the user must remember that: 


will give the address of the first (lowest) 

core locations occupied by the System Pro— 

gram / BBI combination when it is~loaded 

will give the TOTAL size of the System 
Program/BBI combination. ” ' . 

will.give the starting address of the BBI 
routine (first address above Transfer Vec¬ 
tor address table). 


NOTE 

The program system parameter commands listed above 
may not be used: 

a. when a program has not been selected or 
the command CTRL P (+P) has been entered; 

b. when SYSBLK has been selected; 

c. when the commands B, B+, or B- are in ef¬ 
fect. 
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The five SYSBLK Parameter commands operate in a manner similar to the 
List (L) command. When entered, the corresponding parameter location 
address and contents are printed out followed by a go-ahead symbol (>) 
as for the L command. As in other list operations, the user may, ac¬ 
cording to the manner in which terminators are used: 1) modify the 
opened register, 2) view the next sequential register, 3) view the 
preceding register, 4) jump to and view the location addressed by the 
contents of the last opened register, or 5) terminate the operation. 

The operations initiated by a Parameter command are carried out on the 
SYSBLK information contained by the PATCH command table. This SYSBLK 
data is obtained by PATCH when it is first loaded into core and prior 
to the start of user PATCH operations. On completion of each SYSBLK 
Parameter command operation (ALT MODE terminator used), the modified 
(or unchanged) command table SYSBLK is copied onto the system at .DAT-14. 

The five separate commands are provided by PATCH as a convenience for 
the user,” they permit the user to obtain a specific parameter or to 
start listing operations at a specific point with a simple straight¬ 
forward command. The complete series of five program parameters may 
be obtained simply by starting with the FB command and advancing the 
listing operation through the next four sequential word locations. 

This method is the only way to modify .SYSBLK parameters without re¬ 
loading PATCH since it also modifies the PATCH command table. 

EXAMPLE: 

The following example illustrates the use of a PATCH SYSBLK parameter 
command to obtain and modify the first address occupied, program size 
and starting address parameters for the system program currently in 
core. 


> FA J 

00066/013670>13660 J 

00067/003747>3757 J 
00070/013671>13661(ALT MODE) 


parameter command 
first address opened and modi¬ 
fied 

program size opened and modified 
starting address opened and 
modified and operation termi¬ 
nated. 
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5.6 MODIFYING REGISTERS IN DATA BLOCKS 


User 8 s can modify registers in data blocks (on the device assigned to 
.DAT-14) through the identical use of the ’ B 6 command and the ' L' 
operation,, 

This facility is utilized in a UC15 system to patch PDP-11 programs, 
through octal expressions. 
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SECTION 6 


SUMMARY t OPERATING PROCEDURES AND ERROR MESSAGES 

6.1 CONTENTS 

Brief procedural descriptions of the operations needed before loading 
the PATCH program and for the performance of each PATCH function are 
given in this Section. Error detection and error messages are also 
described. 

6.2 PRE-LOAD OPERATIONS 
6.2.1 .DAT Slot Assignments 

The user must make the .DAT slot assignments given in Table 6-1 
immediately prior to loading the PATCH program. 


Table 6-1 Required .DAT Slot Assignments 


.DAT Slot 


Used to 


14 


-10 


Permanently 

Assigned 


-3 

-2 


Input from and output to the device 
on which patches are to be made. 

The device handler is required only to 
perform .TRAN. 

Input from the auxiliary device. 

The device handler must handle Dump 
Mode input and, if it is for a non¬ 
file oriented device, must handle 
image alpha mode. 

Output to the teleprinter. 

Input from the console keyboard or batch 
processing device. 


.DAT slot -10 can be assigned to no device handler (NONE) if auxiliary 
input is not required. .DAT slots -3 and -2 cannot be changed. 


6.2.2 I/O Device Preparation 

The user must ensure that the I/O device assigned to .DAT-14 
(material to be patched) is WRITE ENABLED before starting PATCH 
operations. 


6-1 



If the device is a 


1. DECtape unit - set the unit's WRITE ENABLED/WRITE LOCK 
switch to the WRITE ENABLED position. 

2. Disk ~ set the assigned logical disk unites WRITE 
LOCKOUT switches to their ENABLED positions. 

6.3 CALLING PATCH 

PATCH is called by issuing the command PATCH from the system I/O 
console. When PATCH is loaded and running, it outputs its name 
and version number. For example; 

DOS-15 V3A 
$PATCH) 

PATCH Vnn 

> 

6.4 PATCH OPERATIONS 

The operations which may be performed using PATCH fall into four (4) 
functional groups. Procedures, in table form, are given for the List 
"L" and "LR" functions. 

The Examination and modification of registers in absolute program is 
summarized in table 6-2. The examination and modification of registers 
in Patch™ READ R-installed system programs summarized in table 6-3. 

6®4»1 Replacing Absolute Programs from External PATCH Files 
The required, procedure is to: 

a. Select Program or data block to be patched (e.g. ^DIT^)). 

b. Specify READ operation and input file with the command 
string 

>READ g _ a .[f ilename] J (e.g., >READ 6 _ Ji EDPCH^) 
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6.4.2 Installation of Relocatable Programs as Absolute SYS Files 


The required procedure is: 


a* Select the system device area prepared (by SGEN) to 
receive the new SYS file (e.g., >NUFIL £ ) . 

b. Enter the PATCH READR command using the following 
format: 

>READR9««jinnnnn3u[ filename] J (e.g., >READR l ^7600§ <ra jNUFIL^) 

NOTE 

“nnnnn" represents the highest register the new SYS 
file will occupy when loaded into core. In the 
example, this is specified as 17600% which would 
leave a 3 6n-word buffer between the top of the SYS 
file and the first Bootstrap location. The default 
value of nnnnn=17636g. 

6.5 ERROR DETECTION 

PATCH, on the detection of an error, causes the•following: 


1) the current function is terminated; 

2) the data block (program or selected block) current in 
the PATCH Block Buffer is output to the device at 
.DAT-14 if modifications had been made to the block; 

3) an appropriate error message is output at the user’s 
I/O terminal. 


In the event of an .IOPS error, control is not automatically returned to 
the monitor. PATCH can be restarted by the entry of a CTRL P (IP) 
command. CTRL P is also useful in terminating a read operation in the 
event of an equipment malfunction (e.g., paper tape reader jams). 

In the event of an "I/O device not ready" error (I0PS4), CTRL R may be 
used to continue the current operation after the device involved has 
been made ready. CTRL C may also be used to return control to the 
monitor; however, care must be taken not to use this command when a 
register is open since any modification made to the current block in 
core will be lost. 


6.6 ERROR MESSAGES 


The error messages output by PATCH are listed and described in 
Table 6-4. 
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Operatl^^N^ 

Item to be Patched 

BLOCK 

PROGRAM 

PROGRAM 

SYSBLK 

PARAMETERS 

SELECT ITEM 

TO BE 

PATCHED 

> B, , nj o r 

> B *L»s or 

>Prog. Name^ 

>Prog. NameJ 

SELECT 
REGISTER OR 
PARAMETER 

> Xj n ^ 
u 

> L n 

> FA J or 

> FB J or 

> NB ^ or 

> PS J or 

> SA J 

MODIFY 

OPENED 

ITEM 

ENTER NEW CONTENTS IMMEDIATEI 
OUTPUT WHEN LOCATION WAS OPEt 

e.g., > Address/ Old Contents > Ne 

jY AFTER RESPONSE 
[ED. 

;w Contents 

SELECT 

NEXT 

OPERATION 

TERMINATE RESPONSE LINE ACCORDING TO DESIRED NEXT 
OPERATION: 

J go to next sequential location open 

and list address and contents 

f J go to preceding register, open and 

list address and contents 

■*— $ go to register identified by contents 

of current register, open and list 
address and contents 

ALT terminate current list operations 

MODE 


Table 6-2, Procedure for Modifying Registers in Absolute System Programs 
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H“ 

Item To Be Patched 

PROGRAM 

PROGRAM 

SYSBLK 

PARAMETERS 

SELECT ITEM 

> Prog. Name J 

>Prog. Name^J 

SELECT REGISTER OR 
PARAMETER 

>LR n J 
u 

>FA J or 
>FB J or 
>NB"^J or 
>PS J or 
>SA«@^ 

MODIFY OPENED 

ITEM 

ENTER NEW CONTENTS IMMEDIATELY AFTER RESPONSE 

OUTPUT WHEN LOCATION WAS OPENED. USE RELOCATION 
FACTOR (#) WHEN CHANGING MEMORY REFERENCE OR 
TRANSFER VECTOR REGISTERS. 

e.g., standard register 

> relocated . old new 

address ' contents contents 

memory reference instruction or transfer 
vector 

> relocated , old < unrelocated > new 

address ' contents address of contents 

contents + # 

SELECT NEXT 
OPERATION 

TERMINATE RESPONSE LINE ACCORDING TO DESIRED 

NEXT OPERATION: 

J go to next sequential location 

open and list address and con¬ 
tents 

go to preceding register, open 
and list address and contents 

go to register identified by 
contents of current register, 
open and list address and con¬ 
tents . 

ALT terminate current list operations 

MODE 


Table 6=3. Procedure for Modifying Registers in PATCH-READR- 

Installed. System Programs 
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Table 6-4 


Printout 

ILLEGAL COMMAND 

NOT OCTAL DIGIT 

TOO MANY DIGITS 

ADDRESS OUT OF RANGE 

CHECKSUM ERROR 

FILE NOT FOUND 

ILLEGAL BLOCK # 

ILLEGAL SIZE 

MORE THAN 256 

TRANSFER VECTORS 

NOT RELOCATABLE BINARY 

.GLOBL NOT ALLOWED 

LAST ADDRESS GREATER 
THAN 17636 


ERROR MESSAGES 


Meaning 


a. An attempt was made to issue a command 
before a file or block was selected. 

b. Command unrecognizable. 

A character other than an octal digit was 
encountered where an octal digit was 
expected. 

The command string contains an octal number 
with more than 6 digits. 

a. The address requested is not within the 
legal range of the currently selected 
program or block. 

b. Address or size argument of a SYSBLK 

command is greater than 17645 or is 
negative. ° 

Bad data read in from auxiliary input device 
(checksum, parity, or validity bits) - try 
again. 

The file named in a READ or READR command does 
not exist on the auxiliary device. 

The block number specified in a Block 
Selection command was less than 0. 

a. The program size (PS command) exceeds the 
number of blocks allotted for the current 
program. 

b. The size of the program (including the 
bank bit initialization routine supplied 
by PATCH) input by a READR command exceeds 
the number of blocks allotted (during 
system generation) for the SYS file or 

is greater than nnnnn-20 . 

O 

The program being input by a READR command 
contains more than 256 transfer vectors. 

The program being input by a READR command 
is not a relocatable binary file. 

The program being input by a READR command 
contains an external .GLOBL (internal .GLOBL 
ignored). 

The last address of the program input by a 
READR command is greater than 17636g. 
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APPENDIX A 


SYSTEM BLOCK (SYSBLK) DESCRIPTION 


A.1 SYSTEM BLOCK (SYSBLK) 

In each of the primary PDP-15 monitor systems (ADSS, DOS) the monitor 
contains a System Block table (abbreviated as SYSBLK) which contains 
the name, physical parameters and VO information for each system pro¬ 
gram in the software system. 

The information contained by SYSBLK in the initial operating system is 
determined during System Generation procedures? refer to the SGEN 
manual (DEC-15-YWZB-DN3 or DEC-15-USGNA-A-D). SYSBLK is used by the 
system loader programs in locating and loading selected (called) 

System Programs into core. 

PATCH, when first loaded into core, checks for a SYSBLK at .DAT -14 and, 
if one is present, it loads the SYSBLK Parameter Table into core as a 
PATCH Command Table. This command table is used unchanged during all 
subsequent PATCH System Program operations, including SYSBLK modifica¬ 
tion operations. 

SYSBLK, itself, is divided into two distinct areas (see Figure 2-1) , a 
Parameter Table, and a Communications Table (named COMBLK in DOS systems). 
PATCH operations normally concern only the SYSBLK Parameter Table. 


ADSS 


SYSBLK 


PARAMETER 
- TABLES 




FREE AREA 


COMMUNICATIONS 
DATA GROUPS 



J 


DOS 


SYSBLK 


COMBLK 


Figure A-l 

System Block, Overall Configuration 
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A.1.1 SYSBLK Parameter Table 

Both the ADSS and DOS SYSBLK parameter tables contain separate seven- 
word parameter groups for each System Program in the operating system. 
Each parameter group consists of the following: 

CONTENTS 

Name of the System Program or overlay (i.e., PATCH, 

DDT, EDIT, etc.) in .SIXBT form. 

The number of the first system device block occupied 
by this System Program or overlay. 

The amount of system device blocks allotted to con¬ 
tain the program. For PATCH-installed programs, this 
number is allocated during user SGEN procedures„ 

The address (13-bit) of the first core locations that 
will be occupied by the System Program when it is 
loaded. 

The size of the program. 

The program starting address (13-bit) . 

An example of an ADSS System Program parameter table is given in 
Figure 2-2. 

OCTAL 
PRINTOUT 

WORD CONTENT 

00010 050411 

00011 240000 

00012 000630 

00013 000012 

00014 013000 

00015 004636 

00016 013000 

Figure A-2 


INTERPRETATION 

Program name "EDIT" in .SIXBT code. 

The first block occupied by EDIT is 
630g. 

Twelve blocks (octal) are allotted to 
hold the program EDIT. 

The first core location 1 occupied by 
EDIT is 13000 ^. 

EDIT consists of 4636 0 words. 

O 

Program start address 1 is at core loca¬ 
tion 13000q. 


WORD 
1 & 2 

3 

4 

5 

6 
7 


System Program EDIT SYSBLK Parameter Group 

At load time, the bank bits of the highest 8K system bank are added to 
this address to properly locate the program in the highest bank. 
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A.1.2 Communications Table 


ADSS system block communication areas contain individual .DAT slot lists 
for each system program and a master .DAT slot list pointer table. 

DOS system block COMBLK area contains individual communication data 
groups which store .DAT slot, buffer, and overlay information for 
each system program. 





APPENDIX B 


SYSTEM PROGRAMS, GENERAL DESCRIPTION 


System Programs have a unique feature in that they are loaded into 
core and are started by only the entry, of a single user command (i.e., 
program name) at the system console keyboard. This feature is imple¬ 
mented by name, control parameters, and I/O device information con¬ 
tained for each System Program in the system SYSBLK Parameter and 
Communication (COMBLK) tables. The information contained in SYSBLK 
enables the Keyboard Monitor to recognize System Program names (as 
stored in SYSBLK) and causes it to initiate the loading of the identi¬ 
fied program into core. 

System Programs and their associated Device Handlers are loaded into 
core from the system device by the System Loader (.SYSLD) program. 

The placement of System Programs and their device handlers in core is 
illustrated in Figure 2-3. As shown: 

1) System Programs are always loaded immediately below the 
Bootstrap in the highest portion of the highest 8K bank 
in the system, except for MACH which is always loaded 
into 5 Bank I s of the system* 

2) In systems which include an extra 4K page (e.g., 12K, 

20K, 28K, etc.) the extra 4K portion is used, during 
loading operations, only for handlers. 

3) The lowest register which a System Program may occupy 
is 20g in the highest 8K bank of the system; handlers 

and. free core may be located anywhere in the system. 

System Programs are stored on the system device as absolute executable 
files identified by the file name extension "SYS" (for ADSS only) and 
are commonly referred to as "SYS files". Software is supplied to the 
user and contains a standard group of commonly used utility and lang¬ 
uage programs installed on some medium (e.g., DECtape) as SYS files. 
The SGEN and PATCH utility programs can be used to delete the supplied 
SYS files or replace them with other Digital-supplied programs or 
with user programs. Table 2-1 lists the names and SYSBLK entry 
names of the System Programs supplied with PDP-15 software systems. 
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I 


EXTRA 1 
4K PAGE I 


BOOTSTRAP 



17777g 
176 36 8 


4- N 

+ N 


SYSTEM 
PROGRAM 
(SYSfile) 
except MACH 


SCOM + 3 


■ 00020 8 


+ N lower limit 
for SYSfile 


DEVICE 

HANDLERS 


RESIDENT 

MONITOR 


««£- 


.SCOM + 2 


.SCOM + 1 


-0 


LEGEND: N = 00000 for 8K systems 

= 20000 for 16K systems 
= 40000 for 24K systems 
= 60000 for 32K systems 


Figure B-l, 


Memory Map, Loading System Programs 
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INDEX 






»ABS macro program, 4-2 
Absolute address information, 5-6 
Absolute address values, 3-3 
Absolute files transfer, 4-1 
ADDRESS OUT OF RANGE error, 4-2 
Address relocation, 3-2 
Addresses in LR List operations,5-6 
ALT MODE, 5-4 

Asterisk (*) symbol, operator, 5-3 
At symbol (@) (ALT MODE), 5-4 


B command (Block Select), 2-3 

Bank Bit Initialization routine, 

3-2 through 3-5 

word location requirement, 3-5 
Batch control operation, 1-1 
Block relocation, 2-3 
Block Select (B), 2-3 

command, 4-2 


Calling PATCH, 6-2 
Changes to SYSBLK parameters, 4-4, 

4-5 

Command, 

B, 2-3 
L, 5-4 
LR, 5-6 
READ, 4-1 

READR, 3-1, 3-2, 3-3 
SYSBLK commands, 

FA, 5-10 

FB, 5-10 
NB, 5-10 
PS, 5-10 
SA, 5-10 

Commands, 

Block Select, 4-2 
Program Select, 4-2 
Select, 5-1 
SYSBLK, 5-10 
Comments, 2-3 
Common data storage, 3-5 
COMMON references, 3-2 
Communications Table, A-3 
Conversion of relocatable file 
to absolute SYS file, 3-1 
Core image size, 3-2 
CTRL Q area ( 1 QAREA) , 2-1 

®DAT slot assignment, 1-3, 6-1 
0 DAT slot lists, A-3 
Data blocksjr modifying, 5-12 
Data flow paths, 1-3, 1-4 
DECdisk preparation, 6-2 
DECtape preparation, 6-2 
Device assignments, 6-1 
Disk preparation, 6-2 


Documents, supporting, 1-2 
Dump Mode, 6-1 


Error, 

address out of range, 4-2 
detection, 6-3 
messages, 6-6 

Evaluation of expression, 5-3 
Examples of Select, List and 

Modification procedures, 5-5 
Examples, Relocation and LR List 
operation, 5-8, 5-9 
Exclamation point symbol (!), 
operator, 5-3 
Expressions, 5-2 
evaluation of, 5-3 
null, 5-3 


File conversion, relocatable 
to absolute, 3-1 
Filename extension, READ 
command, 4-2 
Filename omission, 3-1 
Filename, paper tape files, 4-2 
Function, 

List, 5-1 
load, 3-1 
READ load, 4-1 
Select, 2-1 

Functions of PATCH, 1-3, 6-2 


.GLOBL references, 3-2 
Go ahead symbol (>), 5-5 


Identification of program, 2-1 
Image alpha mode, 6-1 
Inclusive OR, 5-3 
Indexed instructions, 3-2 
Input devices, 1-1, 6-1 
Input expressions for register 
modification, 5-8 
Input file requirements, 3-2 
I/O device preparation, 6-1 
I/O data flow paths, 1-3, 1-4 


LAW symbol, 5-3 

Linking Loader system program, 3-3 
List function, 5-1 
L command, 5-1, 5-4 
LR command, 5-1, 5-6 
SYSBLK parameter command, 5-1 

5-10 

List operation, 5-2 
line terminator, 5-4 
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L List command, 5-4, 5-5 
LR List command, 5-6 

register modification procedure,5-7 
Load address specification, 3-5 
Load function, 3-1 
Loading absolute programs, 4-1 
Loading relocated core image 
system programs, 3-6 
-LOC statements as pointers, 4-3 

MACRO 11, 3-7, B-l, B-2 
MACRO 15 assembler, 3-3 
Major functions of PATCH, 1-3 
Memory Map, READR SYS file, 3-7 
Messages, error, 6-6 
Minus sign (-) operator, 5-3 
Modes, 

dump, 6-1 
image alpha, 6-1 


Naming program, 2-1 
Null expression, 5-3 
Number symbol (#) usage (relocation 
factor symbol), 3-3, 5-6, 5-8 


Operators recognized by PATCH, 5-3 
Output device, 6-1 


Parameter changes, SYSBLK, 4-4, 4-5 
Parameter table, SYSBLK, A-2 
Partial overlay PATCH programs, 4-4 
Plus sign (+) operator, 5-3 
Pointers (.LOC statements), 4-3 
Pound symbol (#) usage (relocation 
factor symbol), 3-3,5-6,5-8 
Precautions, READ operations, 4-4 
Preload operations, 6-1 

Procedure for modifying registers, 

in absolute system programs, 6-4 
in PATCH installed system 
programs, 6-5 
Program 

name, 2-1 
size, 3-2, 3-3 
writing, 4-3 

Program Select command, 4-2 

READ command, 4-1 

load operation, 4-2 
READ operations, precautions, 4-4 
READR file relocation calculation, 

3-3 

READR Load command, 3-1, 3-3 
input file requirements, 3-2 
procedures, 3-2 

READR System Communications area,3-5 
Register modification functions, 5-1 
Relocatable programs installed as 
absolute SYS files, 6-3 
Relocation of block, 2-3 


Relocation factor, 3-3, 5-6 
symbol (#), 3-3, 5-6, 5-8 

Relocation operation, example 
LR command, 5-8, 5-9 
Replacement (complete) of 

programs or data blocks, 4-4 
Right angle bracket (>) (go- 
ahead symbol), 5-5 

Routine, Bank Bit Initializa¬ 
tion, 3-2 through 3-5 


Select command, 5-1 
Select function, 2-1 

Block Select (B) command, 2-3 
Program Select command, 2-1 
SGEN utility program, B-l 
procedures, 3-1, 3-2 
Size 

of core image, 3-2 
of program, 3-2, 3-3 
Summary, 6-1 

Supporting documents, 1-2 
SYS files, B-l 
SYSBLK parameters, 3-2, 4-1 
changes, 4-4, 4-5 
commands, 5-10 
command example, 5-11 
table, A-2 

SYSBLK (System Block), 2-1, A-l 
.SYSLD (system loader), 3-4,3-6,B-l 
System Block, see SYSBLK 
System generation procedures 
(SGEN), A-l 

System Loader (.SYSLD) program, 

3-6, B-l 

System programs, loading, B-l 
System Program SYSBLK parameter 
commands, 5-10 
System programs supplied with 
DOS and ADSS, 2-2 

Tab symbol ( -*|) , 5-3 

Termination of PATCH operations,4-4 
Terminators, list operation 
command string, 5-4 
Transfer vectors, 3-2 
data word format, 3-4 
Two's complement addition, 5-3 
Two’s complement subtraction, 5-3 

UNICHANNEL 15, 3-7 


Writing PATCH programs, 4-3 


XOR (exclusive OR), operator, 5-3 
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HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS; MAILING LIST 


The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products. Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally. For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to: 

Software Communications 

P. 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital’s software should be reported 
to a Software Support Specialist. A specialist is located in each 
Digital Sales Office in the United States. In Europe, software problem 
reporting centers are in the following cities. 


Reading, England 
Paris, France 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number. In 
the United States, send orders to the nearest distribution center. 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative. 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains a user ex¬ 
change center for user-written programs and technical application in¬ 
formation. A catalog of existing programs is available. The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia. For information on the 
society and membership application forms, write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment, S.A. 
81 Route de I'Aire 
1211 Geneva 26 
Switzerland 






READER'S COMMENTS 


PATCH Utility Program. 
Programmer's Reference Manual 
DEC-15-UPATA-A-D 


NOTE: This form is for document comments only. Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable , and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not,, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 
[ j Higher-level language programmer 
[ ] Occasional programmer (experienced) 

[I User with little programming experience 
FI Student programmer 

FI Non-programmer interested in computer concepts and capabilities 

Name_Date___ 

Organization_ 

Street _______ 

City_State_Zip Code_ 

or 

Country 


If you do not require a written reply, please check here. 
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